昨天的問題

Day 2 你啟動了第一個 Agent，讓它自己做完一件事。但你可能有個感覺：

「它很聰明，但它不認識我，也不認識我的專案。每次都要從頭跟它解釋。」

沒錯。昨天那個 Agent 是一張白紙——它是通用的 Claude Code，不知道你的專案規矩、不知道你偏好的風格、不知道它自己該扮演什麼角色。

今天，我們給它一個靈魂。

CLAUDE.md 是什麼？

CLAUDE.md 是一個放在你專案裡的 Markdown 檔案。它的作用只有一個，但威力極大：

每次 Claude Code 在這個資料夾啟動時，都會自動把 CLAUDE.md 的內容讀進去，當成最優先的指示。

你不用每次貼、不用提醒它去看——它自己會讀，而且會照做。

換句話說，CLAUDE.md 就是這個 Agent 的常駐記憶 + 行為守則 + 身分設定。你寫進去的東西，它「開機」就知道。

一個最小的例子

在你的專案根目錄建一個 CLAUDE.md：

# 這個專案

這是一個 Python FastAPI 後端。

## 規則
- 每個檔案不超過 200 行，接近就拆模組
- 用 .venv + requirements.txt，不要自己造輪子
- 寫完 code 一定要跑 pytest 確認綠燈才算完成

## 風格
- 回答我一律用繁體中文
- 給結論先，細節後

存檔，重開 claude，然後叫它做點事。你會發現：

• 它不用你提醒，就知道這是 FastAPI 專案
• 它改完 code 會自己去跑 pytest
• 它回你的話變成繁體中文、先給結論

你沒有在對話裡講這些，它卻全都做到了——因為它開機就讀了 CLAUDE.md。

為什麼這是「從工具變成助手」的關鍵

沒有 CLAUDE.md 的 Claude Code，是一個每次都失憶的天才——聰明，但每次都要重新交代背景。

有了 CLAUDE.md，它變成一個認識你、認識這個專案、記得規矩的專屬助手。差別大到不像同一個工具。

我自己的艦隊裡，每一個 Agent 都有兩層 CLAUDE.md：

1. 全艦隊通用的（放在共用位置）——所有 Agent 都繼承的規矩：時區一律用台北時間、跟人溝通用繁體中文、動外部服務前先讀對應手冊……這些是「艦隊公民守則」。
2. 每個 Agent 專屬的——它自己的職責、它負責哪個專案、它的角色定位。

一個負責客服的 Agent 和一個負責寫規格的 Agent，跑的是同一套 Claude Code，但因為 CLAUDE.md 不同，行為天差地遠。靈魂不同，行為就不同。

該把什麼寫進 CLAUDE.md？

我的經驗是，寫這四類東西 CP 值最高：

1. 這個專案是什麼：技術棧、目錄結構、跑起來的指令。省下每次解釋。
2. 不可違反的規則：像「commit 前一定要跑測試」「不准動 production 設定」——這些是你不想每次都盯的底線。
3. 風格偏好：語言、格式、先結論還是先鋪陳。讓它講話合你的胃口。
4. 常犯的錯 / 陷阱：如果它上次踩了某個坑（例如「這個 API 的 auth 是用 header 不是 body」），寫進去，它下次就不會再犯。

第 4 點特別重要——CLAUDE.md 是活的。每次它做錯、你糾正它，就順手把教訓寫進去。你的 Agent 會一天比一天更懂你的專案。

一個真實的教訓

我踩過一個坑：一開始我以為規則寫得越多越好，把 CLAUDE.md 塞得又長又細。結果反而變糟——太多規則會稀釋重點，Agent 抓不到真正關鍵的那幾條。

後來我學到：CLAUDE.md 要寫「一忘就會出錯」的鐵則，不要寫「知道更好但忘了也沒差」的細節。 前者放常駐，後者放進「需要時才查」的手冊（這就是明天之後會講的 Skill 系統）。

規則的價值不在多，在於每一條都是你真的踩過、不想再踩第二次的坑。

今天的重點回顧

• CLAUDE.md 是專案裡的一個檔，Claude Code 每次啟動自動讀取，當成最優先指示。
• 它是 Agent 的常駐記憶 + 行為守則 + 身分設定——寫一次，它每次開機就知道。
• 這是「通用工具」變成「你專屬助手」的關鍵：同一套 Claude Code，靈魂不同，行為天差地遠。
• 寫「一忘就出錯的鐵則」，不要塞細節；每次糾正它，順手把教訓寫回去，它會越來越懂你。

明天 Day 4：CLAUDE.md 讓 Agent 記得「規矩」，但要記得**「你上個月跟它說過的事」，需要另一套機制——Agent 的記憶系統**。這是讓 Agent 真正「認識你」而不只是「認識這個專案」的一步。

Genos Lin 是一位技術創辦人，同時擔任多個 AI 導入客戶案的技術顧問。他目前維運一套由 39 個 Claude Code Agent 組成的自動化系統，用於產品開發、業務流程自動化與客戶服務。